home *** CD-ROM | disk | FTP | other *** search
/ Deutsche Edition 1 / Deutsche Edition 1.iso / amok / 071-080 / amok71 / cliutil / cliutil.dok < prev    next >
Text File  |  1993-11-04  |  5KB  |  134 lines
  1.  
  2. *********************************************************************
  3. ** Dokumentation fuer CallInt und MakeLink by Franz Schwarz *********
  4. ** English docs can be found in the respective source code header! **
  5. *********************************************************************
  6.  
  7. CallInt  und  Makelink  sind  zwei kurze CLI-Utilities, die einem das Leben
  8. unter  AmigaOS2.04 (oder hoeher) erleichtern.  Gleichzeitig koennen sie als
  9. Musterbeispiele  dienen,  wie  unter  Oberon  kurze  CLI-Utilities, die die
  10. Argumentschablonen   des  OS2.0  verwenden,  programmiert  werden  koennen,
  11. ausserdem   machen   Sie   natuerlich   extensiv  Gegrauch  von  den  neuen
  12. DOS-Funktionen.
  13.  
  14.  
  15.              *****************
  16. Zunaechst zu * C a l l I n t *
  17.              *****************
  18.  
  19. -Version 38.11, Veroeffentlicht am 7.Mai 1992
  20. -das Urheberrecht gilt als der Allgemeinheit uebertragen (Public Domain)
  21.  
  22.  
  23. CallInt   wurde   geschrieben,   um  Software,  die  bestimmte  Befehle  im
  24. C:-Directory   sucht,   welche   aber   inzwischen   in   der  ROM-internen
  25. Residentliste   zu   finden  sind,  trotzdem  -und  unter  allen  kuenfigen
  26. OS-Versionen-  kompatibel  zu  machen.  CallInt muss unter dem Namen in das
  27. C-Directory  kopiert  werden, den der jeweilige Befehl in der ResidentListe
  28. hat.   Soll  z.B.  Software, die c:Run sucht, lauffaehig gemacht werden, so
  29. dann  muss  CallInt  mit  'copy  CallInt c:run' kopiert werden.  Sobald nun
  30. C:Run  gestartet  wird, sucht es in der internen Residentliste des DOS nach
  31. 'run'  und  ruft es mit den uebergebenen CLI-Argumenten auf, auch der Stack
  32. wird beachtet.  Das Ergebnis des Aufrufs wird von CallInt auch uebernommen,
  33. so dass volle Kompatabilitaet gewaehrleistet ist.
  34.  
  35. Uebrigens:  das OS1.3-Run kann zwar auch verwendet werden, jedoch ist nicht
  36. garantiert,  dass  es  zukuenftig  auch funktioniert, da es den BCPL Global
  37. Vektor  verwendet.  Ausserdem vererbt es zum Beispiel nicht die ALIAS-Liste
  38. an den gestarteten Tochterprozeß.
  39.  
  40. Ich empfehle folgende Installation (gegenwaertig unter OS2.04):
  41.  
  42. copy CallInt c:
  43. makelink c:Alias c:CallInt hard
  44. makelink c:Ask c:CallInt hard
  45. makelink c:CD c:CallInt hard
  46. makelink c:Echo c:CallInt hard
  47. makelink c:Else c:CallInt hard
  48. makelink c:EndCLI c:CallInt hard
  49. makelink c:EndIf c:CallInt hard
  50. makelink c:EndShell c:CallInt hard
  51. makelink c:EndSkip c:CallInt hard
  52. makelink c:Failat c:CallInt hard
  53. makelink c:Fault c:CallInt hard
  54. makelink c:Get c:CallInt hard
  55. makelink c:Getenv c:CallInt hard
  56. makelink c:If c:CallInt hard
  57. makelink c:Lab c:CallInt hard
  58. makelink c:NewCLI c:CallInt hard
  59. makelink c:NewShell c:CallInt hard
  60. makelink c:Path c:CallInt hard
  61. makelink c:Prompt c:CallInt hard
  62. makelink c:Quit c:CallInt hard
  63. makelink c:Resident c:CallInt hard
  64. makelink c:Run c:CallInt hard
  65. makelink c:Set c:CallInt hard
  66. makelink c:Setenv c:CallInt hard
  67. makelink c:Skip c:CallInt hard
  68. makelink c:Stack c:CallInt hard
  69. makelink c:Unalias c:CallInt hard
  70. makelink c:Unset c:CallInt hard
  71. makelink c:Unsetenv c:CallInt hard
  72. makelink c:Why c:CallInt hard
  73. makelink c:.ket c:CallInt hard
  74. makelink c:.bra c:CallInt hard
  75. makelink c:.key c:CallInt hard
  76.  
  77.  
  78.  
  79.  
  80. *******************
  81. * M a k e l i n k *
  82. *******************
  83.  
  84. -Version 38.1, Veroeffentlicht am 24.April 1992
  85. -das Urheberrecht gilt als der Allgemeinheit uebertragen (Public Domain)
  86.  
  87.  
  88. Makelink  ist  nichts  weiter  als  ein Bugfix zu Commodore's Makelink, das
  89. unter   OS2.04  immer  noch  keine  Softlinks  unterstuetzt,  obwohl  diese
  90. mittlerweile  funktionsfaehig sind.  Commodore hat zwar die Schablone schon
  91. daraufhin abgestimmt, aber der Schalter HARD/S wird ignoriert.  Deshalb ist
  92. es  mit  Commodore's  Makelink nicht moeglich, Softlinks zu generieren, die
  93. den  unschaetzbaren  Vorteil  haben,  ueber  Partitions-  und Devicegrenzen
  94. hinweg  eingesetzt  werden  zu koennen.  Diese Oberon-Version behebt dieses
  95. Defizit,  und  generiert falls der Schalter HARD/s nicht explizit angegeben
  96. ist, Softlinks.
  97.  
  98. Um  zum  Beispiel  einen  Link  dh0:oberon  auf  das  Directory  dh1:oberon
  99. verweisen  zu lassem, muss nur das Oberon-Makelink mit 'makelink dh0:oberon
  100. dh1:oberon  force'  aufgerufen  werden, fertig.  Der FORCE/S-Schalter wurde
  101. vom  Commodore-Makelink  beibehalten, um kompatibel zu sein.  Er muss immer
  102. dann  angegeben  werden, wenn ein Link auf ein Verzeichnis generiert werden
  103. soll.
  104.  
  105. Die Schablone von MakeLink entspricht der von Commodore's Makelink:
  106. FROM/A,TO/A,HARD/S,FORCE/S
  107.  
  108. Das war's.
  109.  
  110. Um keine Mißverständnisse aufkommen zu lassen:  Softlinks bleiben erhalten,
  111. falls  der  Computer  ausgeschaltet  wird, oder ein Kaltstart durchgefuehrt
  112. wird.    Sie   heißen   nur   deshalb   Softlinks,   weil  der  Prozeß  des
  113. Derefernzierens  von  DOS  und  den  entsprechenden Dateisystemen dynamisch
  114. geschieht  zur  Zugriffszeit  geschieht.   Hardlinks  hingegen  werden  vom
  115. jeweiligen Dateisystem allein statisch angelegt, das DOS braucht sich darum
  116. nicht zu kuemmern.
  117.  
  118.  
  119.  
  120.  
  121. Anregungen, Hinweise, evtl. Fehler-Berichte, oder ae. bitte an:
  122.  
  123. Franz Schwarz
  124. Muehlenstrasse 2
  125. D-7201 Durchhausen
  126. Germany
  127.  
  128. oder bevorzugt per email an eine der folgenden Addressen:
  129.  
  130. FIDO: Franz Schwarz, 2:241/7506.18
  131. uucp: Franz_Schwarz@p18.f7506.n241.z2.fidonet.org
  132.  
  133.  
  134.